gsk: Fix a doc oversight

Merge branch 'fix-gi-warning' into 'master'

Fix a warning caused by difference between prototype and definition

See merge request GNOME/gtk!2849

Merge branch 'wip/exalm/caption' into 'master'

widget-factory: Fix caption style class name

See merge request GNOME/gtk!2850

widget-factory: Fix caption style class name

It's lowercase.

Fix a warning caused by difference between prototype and definition

This commit fix the warning:

../gdk/wayland/gdkdisplay-wayland.c:1079: Warning: GdkWayland: gdk_wayland_display_set_cursor_theme: unknown parameter 'name' in documentation comment, should be 'theme'

Merge branch 'gsk-binding-api' into 'master'

gsk: Avoid using gtk css types in public api

Closes #2454

See merge request GNOME/gtk!2848

gsk: Avoid using gtk css types in public api

Using GtkCssSection in public headers here may be
ok from the C perspective, since it all ends up in
the same library anyway. But it causes circular
dependency problems for our gir files that are still
split by namespace.

To avoid this problem, copy the GtkCssLocation struct
struct as GskParseLocation, and pass take two of them
instead of a GtkCssSection in the error callback.

Update all users.

Fixes: #2454

Merge branch 'matthiasc/for-master' into 'master'

popover: Fix submenu navigation

Closes #3301

See merge request GNOME/gtk!2847

popover: Fix submenu navigation

In commit 024d832d943b2abf4f0d, we introduced a
cascade-popdown property that makes closing a submenu
propagate up and close its parent menus. This is the
behavior we want when a menuitem in the submen is
activated.

What we overlooked is that we still need to be able to
close a submenu during navigation, before opening another
one. And in this case, propagating the closing is breaking
things. Fix this by adding a private close_submenu api
to GtkPopoverMenu that avoids the propagation.

Fixes: #3301

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!2846

Merge branch 'ebassi/for-master' into 'master'

Ebassi/for master

See merge request GNOME/gtk!2840

widget-factory: Remove an unused popover

We are no longer using the hand-rolled variant of that
popover on page 3, so drop it from the ui file.

Merge branch 'wip/exalm/button' into 'master'

Allow pressing multiple buttons at once on touch

See merge request GNOME/gtk!2813

Merge branch 'wip/jimmac/popover-menu-submenus' into 'master'

Adwaita: fix up submenus again

See merge request GNOME/gtk!2845

Merge branch 'wip/chergert/for-master' into 'master'

gsk: use glFrameBufferTexture2D and release texture

See merge request GNOME/gtk!2842

Merge branch 'wip/jimmac/circular-button-focus' into 'master'

Adwaita: circular button focus

Closes #3368

See merge request GNOME/gtk!2844

Adwaita: fix up submenus again

- move menubar section under more generic popover.menu
  rather than resort to specificity dir(ltr) hacks

Adwaita: circular button focus

- have the same focus look like the other items

Fixes https://gitlab.gnome.org/GNOME/gtk/-/issues/3368

Merge branch 'wip/jimmac/spinbutton-spacing' into 'master'

Adwaita: spinbutton spacing

Closes #3370

See merge request GNOME/gtk!2841

a11y: Ensure valid object paths in the fallback code

When falling back to using the program name to create a unique base path
for the objects on the accessibility bus we need to ensure that the name
is a valid DBus object path.

gsk: use glFrameBufferTexture2D and release texture

glFrameBufferTexture maps to all faces of a cube and that is not needed
here. Additionally, texture_id is not deleted after we use the additional
flipped texture, but should be.

Adwaita: spinbutton spacing

Fixes https://gitlab.gnome.org/GNOME/gtk/-/issues/3370

a11y: Implement atspi.Cache

The AT-SPI cache interface is used to quickly populate the accessible
objects tree.

The tricky bit is ensuring that we emit change notifications on the
cache only when the cache is available, which means waiting until the
root is asynchronously registered.

a11y: Update the Cache interface introspection

The type for cached items is, unsurprisingly, wrong when compared to the
implementation inside atk-spi2-atk.

a11y: Add getters for GtkAtSpiContext

We are going to use them in order to implement atspi.Cache.

a11y: Use the tab widget to label the notebook stack page

a11y: Compute the base path in the root object

The root path is shared by all AtSpiContext instances, so we should
compute it once, instead of every time we instantiate a new context.

This allows us to defer the path creation at realization time and ensure
that we have a registered application.

a11y: Resync the AT-SPI XML

Mostly just changes in the annotations coming from at-spi2-core, but
it's good to try and keep the XML in sync.

Merge branch 'wip/jimmac/circular-button-padding' into 'master'

Adwaita: circular buttons

See merge request GNOME/gtk!2838

docs: Mention cairo-gobject as build requires

Using cairo from a system dependency and cairo-gobject
as subproject is problematic and left me stuck on a
hard-to-understand build error.

Adwaita: circular buttons

- the vertical padding was thown off with the chin/forehead of menus removed

Merge branch 'wip/jimmac/menu-clipped-shadow' into 'master'

Wip/jimmac/menu clipped shadow

Closes #1987

See merge request GNOME/gtk!2837

Adwaita: avoid clipping menu/popover shadow

Fixes https://gitlab.gnome.org/GNOME/gtk/-/issues/1987

gsk: Fix some docs oversights

These apis have been renamed a few times, and the docs
haven't kept up.

gdk: Docs cosmetics

Add a few missing parameters in doc comments.

docs: Fix a typo

docs: Remove gtk_render_insertion_cursor

This function was removed in 2bcef7f03058dac7cbac.

Adwaita: remove chin on menus

- clipping a rounded corner seems to be working fine for first and last item.

Addresses https://gitlab.gnome.org/GNOME/gtk/-/issues/3366

Merge branch 'wip/jimmac/subtle-sidebar' into 'master'

Adwaita: navigation sidebar color changes

Closes #3362

See merge request GNOME/gtk!2836

Adwaita: navigation sidebar color changes

- use more subtle selected state grey

Fixes https://gitlab.gnome.org/GNOME/gtk/-/issues/3362

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!2835

gtk-demo: Plug a memory leak

The Characters demo was leaking its columns.

modelbutton: Fix keynav for check and radio

The expected behavior when activating check or radio
menuitems via keynav is that Space toggles the item
but keeps the menu open, while Return toggles the
item and closes the menu.

Merge branch 'fix-tooltip-trigger' into 'master'

Fix tooltip triggering

See merge request GNOME/gtk!2833

Fix tooltip triggering

Ever since 5b5d2665d373c35f, tooltips don't work properly,
since we get more motion events now, and those keep the
tooltips from appearing. This can be seen e.g. on the icon
in the password entry in widget-factory, or on the section
switcher buttons in the Emoji chooser.

Ignore synthetic motion events for the purposes of
determining whether the user moved the mouse.

Merge branch 'widget-no-a11y-crash' into 'master'

gtkwidget: fix crashes with GTK_A11Y=none

Closes #3333

See merge request GNOME/gtk!2834

gtkwidget: fix crashes with GTK_A11Y=none

at_context can be NULL in that case, so guard against it.

Fixes #3333

Merge branch 'button-fill-var-removal' into 'master'

Adwaita: Stop using $button_fill

Closes #3354

See merge request GNOME/gtk!2828

Merge branch 'parse-debug-env-vars-always' into 'master'

Always parse GTK/GDK/GSK_DEBUG env vars and make some entries available in non-debug mode

See merge request GNOME/gtk!2830

Revert "Update comment annotations of gtk_tree_model_iter_previous and gtk_tree_model_iter_next to state that the ITER parameter is modified."

This reverts commit 1340ff2bc279329dc16b8d823100fec46b2f11d8.

Same as with 53cd499621b5

Always parse GTK/GDK/GSK_DEBUG env vars and make some entries available in non-debug mode

Currently GTK can be built with G_ENABLE_DEBUG which enables various debug code and parsing
of those env vars, or without, which instead of parsing them prints a warning if they are set.
While building with G_ENABLE_DEBUG isn't strictly needed it's the only way to make GTK_DEBUG=interactive work,
which is a nice thing to have always.

This enables parsing of those env vars in any case and allows specific values being marked as also
available when not built with G_ENABLE_DEBUG (interactive for example). If not built with G_ENABLE_DEBUG
then all unavailable values will be marked as such in the help output and a note is added that
GTK needs to be built with G_ENABLE_DEBUG to use them, which should help discoverability.

Update Ukrainian translation

Merge branch 'wip/carlosg/for-master' into 'master'

gtk/main: Reset active state on grab broken only if implicit

See merge request GNOME/gtk!2832

gtk/main: Reset active state on grab broken only if implicit

An implicit grab means some button is down, reset the active state
only in that case when we get a grab broken event.

Avoids active state accounting warnings when we do get active grabs
broken (e.g. after selecting a menu option).

Adwaita: Stop using $button_fill

Since the $button_fill variables are no longer used outside of the
button() mixin (and it was for an ugly hack), there is no need to keep
that anymore.

Fixes https://gitlab.gnome.org/GNOME/gtk/-/issues/3354

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

Closes #3359 and #3353

See merge request GNOME/gtk!2827

Adwaita: Fix list separators

Commit bfe5b0d1b7a1374964 ran into some specificity
trouble.

Fixes: #3353

label: Avoid short-circuiting

Commit 0db504edde63eb77e made a mistake described here:
https://en.wikipedia.org/wiki/Short-circuit_evaluation#Possible_problems

Fixes: #3359

Merge branch 'alatiera/nightly-demos' into 'master'

ci: publish demo apps to the Nightly repository

See merge request GNOME/gtk!2825

Merge branch 'wip/jimmac/tooltips' into 'master'

Adwaita: tooltip styling

Closes #3352

See merge request GNOME/gtk!2826

ci: publish demo apps to the Nightly repository

Adwaita: tooltip styling

- balance padding
- increase border radius, yuck
- get rid of text shadow

Fixes https://gitlab.gnome.org/GNOME/gtk/-/issues/3352

Merge branch 'wip/jimmac/submenus' into 'master'

Wip/jimmac/submenus

See merge request GNOME/gtk!2824

Merge branch 'wip/jimmac/declare-buttonfill-once' into 'master'

Adwaita: double declated $button_fill

See merge request GNOME/gtk!2823

Adwaita: rounded submenus

- all corners have rounded corners

See https://gitlab.gnome.org/GNOME/gtk/-/issues/2745

Adwaita: double declared $button_fill

- this was already in place in _common, no need to have it in _colors

Adwaita: double declated $button_fill

- this was already in place in _common, no need to have it in _colors

Merge branch 'wip/exalm/window' into 'master'

Round window corners

See merge request GNOME/gtk!1952

Merge branch 'wip/carlosg/for-master' into 'master'

Improve handling of ::active with touch and multiple foci

Closes #3348

See merge request GNOME/gtk!2821

gtk/main: Stack ::active calls

We may have the situation of multiple touchpoints in the same
widget, or combinations with other devices. Stack those ::active
states are preserved on widgets on all but the last pointer/touch
going away.

gtk/main: Toggle active flag with touch events

This went missing at some point, add the missing toggling of active
state with GDK_TOUCH_BEGIN/END/CANCEL events.

Fixes: https://gitlab.gnome.org/GNOME/gtk/-/issues/3348

Merge branch 'ebassi/for-master' into 'master'

Ebassi/for master

See merge request GNOME/gtk!2819

a11y: Use GROUP role for ShortcutsShortcut

And hide the image from the accessible tree.

a11y: Implement atspi.Text.ScrollSubstringTo for GtkTextView

We reuse the existing implementation in GTK3.

a11y: Document GtkRevealer's accessible state

Use the GROUP role, and make sure to note that the child is always
revealed. Unlike GtkExpander, GtkRevealer can only be programmatically
toggled, so we cannot turn it into a "button" object.

a11y: Add more accessible data to GtkTreeExpander

Document the role of the GtkTreeExpander, and the behaviour of the
expander button.

Additionally, improve the label of the expander button, by adding a
fixed "Expand" label, and setting the "labelled-by" relation to the
child of the GtkTreeExpander.

Establish a control relation between demo search and list

The search entry changes the content of the list view, so we should
mention that relation to assistive technologies.

a11y: Add accessible actions to GtkSearchEntry

Just like GtkPasswordEntry, GtkSearchEntry should have its set of
accessible actions.

a11y: Mark SearchEntry icons as presentational

While the "clear the search entry" icon behaves like a button, we don't
have any actual action that can trigger it, so let's ignore it.

a11y: Set the role on GtkSearchBar

The search bar widget has a "SEARCH" landmark role, which is described
as:

    A landmark region that contains a collection of items and
    objects that, as a whole, combine to create a search facility.

a11y: Icons in buttons are presentational

Buttons are described by text, and the icon child can be safely ignored.

a11y: Add more accessibility labels to GtkNotebook

Label the various components:

 - the tab list
 - the tab widget
 - the arrow widgets

a11y: Use the stack page title as its accessible label

a11y: GtkStack is a group of stack pages

Handle empty stack pages when creating an ATContext

If we don't have a widget inside GtkStackPage, we should use the default
GdkDisplay.

Unrealize the ATContext in StackPage on dispose

Otherwise we're going to try to unrealize it during the GtkStack
destruction, which will emit warnings.

a11y: Icons in WindowControls are presentational only

They don't contribute anything to the accessible description.

a11y: Ignore more structural roles when computing labels

These roles should not have a fallback name when explicitly unlabelled.

a11y: Add role exception for GtkScrolledWindow

ARIA does not have a "scroll pane" role, but AT-SPI does.

demo: Add more accessibility labels to the UI

Merge branch 'clear-search-entry' into 'master'

searchbar: Fix clearing search entry on hide

See merge request GNOME/gtk!2820

searchbar: Fix clearing search entry on hide

Commit fa3d1940bf2b36 added separate grab handling for GtkSearchEntry, but
didn't consider whether the bar was revealed or concealed. The expected
behavior for the latter is that the entry is cleared rather than focused,
fix the condition accordingly.

theme: Round all window corners

theme: Restructure window style

Merge branch 'ebassi/for-master' into 'master'

ATContext lifetime fixes

Closes #3341

See merge request GNOME/gtk!2811

Merge branch 'wip/jimmac/sassc-global-vars' into 'master'

Adwaita: avoid !global

See merge request GNOME/gtk!2816

Adwaita: avoid !global

- Work around having !global variables as sassc will
  no longer support it

button: Don't make the gesture exclusive

With the last commit, pressing the same button with multiple fingers
doesn't cause extra emissions, so we can remove exclusive and allow
pressing multiple buttons at once on touch.

gestureclick: Only emit release for the same sequence

Avoid spurious releases when touching the same widget with another finger.

docs: Add "Accessibility" section to various widgets

There are a few widgets that gained an accessible role, which means
adding an "Accessibility" section in their description.